﻿
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- saved from url=(0014)about:internet -->
<html xmlns:msxsl="urn:schemas-microsoft-com:xslt" xmlns:mssdk="winsdk" xmlns:script="urn:script" xmlns:build="urn:build" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="Description" content="The .kdfiles command reads a file and uses its contents as the driver replacement map."/>
<meta name="MSHAttr" content="PreferredSiteName:MSDN"/>
<meta name="MSHAttr" content="PreferredLib:/library/windows/hardware"/>
<title>.kdfiles (Set Driver Replacement Map)</title>

<meta name="MS-HAID" content="r20_metacmds_E_ac521695-c758-497c-bf40-870a5b50011d.xml"/>


<link rel="STYLESHEET" type="text/css" HREF="../common/backsdk4.css"/>





<style>
html,div { margin: 0; padding: 0;}

body {
	padding: 0px;
	margin: 0px;
	overflow: auto;
	height: 100%;
}

#winchm_template_button{
	float: right;
	width: 93px;
	top: 7px;
	position: relative;
	text-align: right;
	right: 5px;
	height: auto;
}

#winchm_template_top{
	padding: 0px;
	margin: 0px;
	border-bottom: 1px solid #9B9B9B;
	background-color: #B1CEFE;
}

#winchm_template_navigation{
	margin: 0px;
	padding-top: 7px;
	padding-left: 7px;
	padding-bottom: 3px;
	padding-right: 0px;
	font-size: 8.5pt;
	font-family: Arial, Helvetica, sans-serif;
	font-weight: normal;
	color: #585858;
}

#winchm_template_title{
	margin: 0px;
	padding-top: 4px;
	padding-left: 7px;
	padding-bottom: 7px;
	padding-right: 0px;
	font-size: 18px; 
	font-family: Verdana, Geneva, sans-serif;
	color: #363636;
}

#winchm_template_content{
	margin-top: 20px;
	margin-left: 15px;
	margin-bottom: 20px;
	margin-right: 15px;
	width: auto  !important;
	width: 100%;
}

#winchm_template_footer{
	border-width: 1px;
	border-color: #B1CEFE;
	border-top-style: solid;
	margin-top: 15px;
	margin-left: 15px;
	margin-bottom: 20px;
	margin-right: 15px;
	padding-top: 7px;
	padding-left: 0px;
	padding-bottom: 0px;
	padding-right: 0px;
	font-family: arial, helvetica, sans-serif;
	font-size: 8.5pt;
	color: #696969;
	width: auto;
	text-align: left;
}


#winchm_template_container{
	margin: 0px;
	padding: 0px;
	position: static;
	padding-bottom: 3px;
	overflow: auto;
	background-color: #FFFFFF;
}


@media print
{
#winchm_template_container{
	position: static;	
	margin: 0px;
	padding: 5px;
	
	width: auto;
	height: auto;
	overflow: auto;
}
#winchm_template_button{
visibility:hidden;
}
}

#winchm_template_navigation A:link	{text-decoration: none; color:#004080}
#winchm_template_navigation A:visited  {text-decoration: none; color: #004080}
#winchm_template_navigation A:active {text-decoration: none; color: #004080 }
#winchm_template_navigation A:hover {text-decoration: none;color: #0080FF}

A:link	{text-decoration: underline; color:#0033CC}
A:visited  {text-decoration: underline; color: #0033CC}
A:active {text-decoration: underline; color: #0033CC }
A:hover {text-decoration: underline;color: #FF0000;}
</style>
<script type="text/javascript">
function isMobile(){
Agent = window.navigator.userAgent;
if (Agent.indexOf("iPhone")>=1 || Agent.indexOf("iPad")>=1 || Agent.indexOf("iPod")>=1 || Agent.indexOf("Android")>=1){
return true;
}else{
return false;	
}

}
function d_onresize(){
if (window.navigator.userAgent.indexOf("MSIE")>=1){
document.getElementById('winchm_template_container').style.pixelWidth = document.body.offsetWidth - 3;
document.getElementById('winchm_template_container').style.pixelHeight = document.body.offsetHeight - document.getElementById('winchm_template_top').offsetHeight - 4;
}
document.getElementById('winchm_template_container').style.top = document.getElementById('winchm_template_top').offsetHeight + 'px';
}

function d_onbeforeprint(){
document.getElementById('winchm_template_container').style.width = 'auto';
document.getElementById('winchm_template_container').style.height = 'auto';
}

function d_onafterprint(){
d_onresize();
}

if(!isMobile()){

window.onload = d_onresize;
window.onresize = d_onresize;
window.onbeforeprint = d_onbeforeprint;
window.onafterprint = d_onafterprint;

document.write("<style>\n");
document.write("body {overflow: hidden;}\n");
document.write("#winchm_template_container {position: absolute;overflow: auto;top : 0px;right: 0px;bottom: 0px;left: 0px;}\n");
document.write("</style>\n");
}

</script>
</head>
<body><script language="JavaScript" type="text/JavaScript">
function syn(){
if(parent.nav.tree){
 if(parent.nav.tree.loaded){
  parent.nav.tree.selectNode(2127);
 }else{
  setTimeout("syn()",500);
}
  }else{
  setTimeout("syn()",500);
  }}
if(parent!=self){
  setTimeout("syn()",100);
}else{
  parent.location.href = "../../index.htm?page=debugger/_kdfiles__set_driver_replacement_map_.htm";
}
originalOnload = window.onload;
if(originalOnload==null){
window.onload = function(){parent.contentLoaded = true;};
}else{
window.onload = function(){originalOnload();parent.contentLoaded = true;};
}
</script> 


<div id="winchm_template_top">
	<div id="winchm_template_button"><A href="_jdinfo__use_jit_debug_info_.htm" title="Previous topic"><img id="winchm_template_prev" alt="Previous topic" src="../template2/btn_prev_n.gif" border="0"></a><A href="_kdtargetmac__display_target_mac_address_.htm" title="Next topic"><img id="winchm_template_next" alt="Next topic" src="../template2/btn_next_n.gif" border="0"></a></div>
	<div id="winchm_template_navigation">Help &gt; 
<A href="introduction6.htm">Debugging Tools for Windows (WinDbg, KD, CDB, NTSD)</A> &gt; <A href="debugger_reference.htm">Debugger Reference</A> &gt; <A href="debugger_commands.htm">Debugger Commands</A> &gt; <A href="meta_commands.htm">Meta-Commands</A> &gt; </div>
	<div id="winchm_template_title">.kdfiles (Set Driver Replacement Map)</div>
</div>
<div id="winchm_template_container">
	<div id="winchm_template_content"><div id="mainSection"><p>The <b>.kdfiles</b> command reads a file and uses its contents as the driver replacement map.</p>
<pre class="syntax"><b>.kdfiles </b><i>MapFile</i> 
<b>.kdfiles -m </b><i>OldDriver</i><b> </b><i>NewDriver</i>
<b>.kdfiles -s </b><i>SaveFile</i> 
<b>.kdfiles -c</b> 
<b>.kdfiles</b> 

</pre>
<h2><a id="ddk_meta_set_driver_replacement_map_dbg"></a><a id="DDK_META_SET_DRIVER_REPLACEMENT_MAP_DBG"></a>Parameters</h2>
<p></p>
<dl>
<dt><a id="_______MapFile______"></a><a id="_______mapfile______"></a><a id="_______MAPFILE______"></a>       <i>MapFile</i>      </dt>
<dd>
<p>Specifies the driver replacement map file to read.</p>
</dd>
<dt><a id="_______-m______"></a><a id="_______-M______"></a>       <b>-m</b>      </dt>
<dd>
<p>Adds a driver replacement association to the current association list.</p>
</dd>
<dt><a id="_______OldDriver______"></a><a id="_______olddriver______"></a><a id="_______OLDDRIVER______"></a>       <i>OldDriver</i>      </dt>
<dd>
<p>Specifies the path and file name of the previous driver on the target computer. The syntax for <i>OldDriver</i> is the same as that of the first line after <b>map</b> in a driver replacement file. For more information about this syntax, see <a href="#Bookmark1411">Mapping Driver Files</a>.</p>
</dd>
<dt><a id="_______NewDriver______"></a><a id="_______newdriver______"></a><a id="_______NEWDRIVER______"></a>       <i>NewDriver</i>      </dt>
<dd>
<p>Specifies the path and file name of the new driver. This driver can be on the host computer or at some other network location. The syntax for <i>NewDriver</i> is the same as that of the second line after <b>map</b> in a driver replacement file. For more information about this syntax, see <a href="#Bookmark1411">Mapping Driver Files</a>.</p>
</dd>
<dt><a id="_______-s______"></a><a id="_______-S______"></a>       <b>-s</b>      </dt>
<dd>
<p>Creates a file and writes the current driver replacement associations to that file.</p>
</dd>
<dt><a id="_______SaveFile______"></a><a id="_______savefile______"></a><a id="_______SAVEFILE______"></a>       <i>SaveFile</i>      </dt>
<dd>
<p>Specifies the name of the file to create.</p>
</dd>
<dt><a id="_______-c______"></a><a id="_______-C______"></a>       <b>-c</b>      </dt>
<dd>
<p>Deletes the existing driver replacement map. (This option does not alter the map file itself. Instead, this option clears the debugger's current map settings.)</p>
</dd>
</dl>
<h3><a id="Environment"></a><a id="environment"></a><a id="ENVIRONMENT"></a>Environment</h3>
<p>You can use the <b>.kdfiles</b> command in Microsoft Windows XP and later versions of Windows. If you use this command in earlier versions of Windows, the command has no effect and does not generate an error.</p>
<table>
<tr>
<td>
<p><b>Modes</b></p>
</td>
<td>
<p>Kernel mode only</p>
</td>
</tr>
<tr>
<td>
<p><b>
          Targets
         </b></p>
</td>
<td>
<p>Live debugging only</p>
</td>
</tr>
<tr>
<td>
<p><b>
          Platforms
         </b></p>
</td>
<td>
<p>x86-based and Itanium-based processors only</p>
</td>
</tr>
</table>
<p> </p>
<h3><a id="Additional_Information"></a><a id="additional_information"></a><a id="ADDITIONAL_INFORMATION"></a>Additional Information</h3>
<p>For more information about and examples of driver replacement and the replacement of other kernel-mode modules, a description of the format for driver replacement map files, and restrictions for using this feature, see <a href="#Bookmark1411">Mapping Driver Files</a>.</p>
<h2>Remarks</h2>
<p>If you use the <b>.kdfiles</b> command without parameters, the debugger displays the path and name of the current driver replacement map file and the current set of replacement associations.  </p>
<p>When you run this command, the specified <i>MapFile</i>file is read. If the file is not found or if it does not contain text in the proper format, the debugger displays a message that states, "Unable to load file associations".</p>
<p>If the specified file is in the correct driver replacement map file format, the debugger loads the file's contents and uses them as the driver replacement map. This map remains until you exit the debugger, or until you issue another <b>.kdfiles</b> command.</p>
<p>After the file has been read, the driver replacement map is not affected by subsequent changes to the file (unless these changes are followed by another <b>.kdfiles</b> command).</p>
<h2>Requirements</h2>
<table>
<tr>
<th width="30%">
<p>Version</p>
</th>
<td width="70%">
<p>Supported in Windows XP and later versions of the Windows operating system.</p></td></tr></table></div></div>	
	<div id="winchm_template_footer">Copyright &copy; 2019. All rights 
reserved. (To change the copyright info, just edit it in template.)</div>
</div>

</body>
</html>
